home *** CD-ROM | disk | FTP | other *** search
/ AOL File Library: 4,401 to 4,500 / aol-file-protocol-4400-4401-to-4500.zip / AOLDLs / Newton Miscellany / NW2 PALMEDIA Player version 2.0 / PMPlay.sit / READMEPC.TXT < prev   
Text File  |  1996-03-29  |  13KB  |  256 lines
  1. PALMEDIA Player version 2.0
  2. Copyright 1996 Lee Moon. All rights reserved.
  3.  
  4. PALMEDIA Player Documentation
  5. Version 2.0
  6. 3/27/96
  7.  
  8. The PALMEDIA Player package allows you to view images on your Newton
  9. MessagePad.  This package combines and extends the capabilities of my
  10. previously released Newton Slide Show and Newton Movie Player.  PALMEDIA
  11. Player runs on Newton OS 2.0 MessagePads only.
  12.  
  13. Features of PALMEDIA Player include:
  14. * Automatic playback mode with user selectable pauses between images.
  15. * Manual viewing mode for moving forward or backwards through the images.
  16. * User selectable transition special effects.
  17. * Movie mode for animation playback.
  18. * Uses images imported (via 3rd party shareware) from a Macintosh or Windows
  19. PC.
  20. * Uses images created with NewtPaint from Landware, Inc.
  21. * Uses sound imported (via 3rd party shareware) from a Macintosh.
  22. * Can be used as a "Helper Application" for Newt's Cape.
  23.  
  24. This version of PALMEDIA Player is a shareware ($10) application for
  25. displaying still images and movies on Newton MessagePads running Newton OS
  26. 2.0.
  27.  
  28. Requirements:
  29. 1) A Newton MessagePad using Newton OS 2.0 with at least 120K-150K free
  30. (either internal or memory card) for PALMEDIA Player, Slurpee, and any soup
  31. tools.
  32. 2) A Macintosh or Windows computer with appropriate communications software
  33. and a Newton serial cable.  Or, if using a Macintosh, PALMEDIA Image
  34. Transfer, a HyperCard stack to use instead of a communications program.
  35. PALMEDIA Image Transfer is much easier than using and configuring most
  36. communications programs (and it's freeware!)
  37. 3) Slurpee 1.8 (recommended) or higher installed on the Newton.
  38. 4) A soup management tool installed on the Newton (not absolutely required,
  39. but recommended as a safety net for removing unwanted images).
  40. 5) Though not strictly necessary, a graphics program capable of saving files
  41. in 1-bit (Black and White) GIF or PICT formats installed on the Macintosh or
  42. Windows computer.
  43. 6) Newt's Cape Graphic Converter installed on the Macintosh or Windows
  44. computer.
  45.  
  46. -or-
  47.  
  48. If you wish to create and view graphics entirely on the Newton, a Newton
  49. MessagePad using Newton OS 2.0 with at least 150K free (either internal or
  50. memory card) for PALMEDIA Player and NewtPaint instead of the requirements
  51. listed above.
  52.  
  53. *** NOTICE ***
  54. Slurpee and Newt's Cape Graphic Converter are shareware packages by Steve
  55. Weyer and Greg Simon.  Please be sure to pay your shareware fees!  Without
  56. their software, you wouldn't be able to import images into PALMEDIA Player.
  57. Here's the URL for more information regarding Slurpee and Newt's Cape:
  58. http://www.netaxs.com/~weyer/newton/newtscape.html
  59.  
  60. Using PALMEDIA Player:
  61. 1) Install the PALMEDIA Player application (PMPlay.pkg) using traditional
  62. means.
  63. 2) Launch PALMEDIA Player via the PMPlay2.0 icon in Extras.
  64. 3) Tap the "Play" button to start (autoplay) the slide show.  The "Play"
  65. button toggles to a "Stop" button while the slide show plays.  Tapping the
  66. "Stop" button halts the show and toggles back to a "Play" button.
  67. 4) The "Slow" button indicates the delay time between images is 5 seconds.
  68. The "Slow" button toggles to a "Fast" button, setting the delay time to 1
  69. second.  Tap the "Fast" button to switch to "Movie" mode.  This mode
  70. configures PALMEDIA Player for animation playback.  Tapping the "Movie"
  71. button switches back to "Slow" mode.
  72. 5) Tapping the up scroll arrow displays the previous image, while tapping the
  73. down scroll arrow displays the next one.  Note that a running slide show or
  74. animation will be stopped when using the arrow buttons.  To resume autoplay,
  75. tap the Play button again.
  76. 6) Tapping the "Pop" button will open a list of all the available special
  77. effects transitions.  You may use this button during autoplay or in manual
  78. mode.  Note that the "Pop" transition essentially displays (pops) the next
  79. image without any special effects.  While in Movie mode, the special effects
  80. button will disappear.
  81. 7) Tapping the "NewtPaint" button switches to "Bitmaps", toggling displayed
  82. images from the NewtPaint image soup to the Bitmaps image soup (used by
  83. Slurpee, MacPictToNewton, Newt's Cape, and Newt).  Note that this button is
  84. hidden during autoplay (you can't change image soups during playback), but
  85. reappears when either the stop, up, or down buttons are tapped.
  86. 8) Tapping the "i" button pops up an information screen.
  87. 9) To remove PALMEDIA Player from your MessagePad, simply use the normal
  88. Remove Software methods.
  89. 10) To import images, use the 3rd party shareware application "Slurpee 1.8"
  90. (older versions will work) along with "Newt's Cape Graphic Converter" (see
  91. the following Notes section for more information) and a communications
  92. program (such as Zterm or PALMEDIA Image Transfer).  Please note that Slurpee
  93. runs on the Newton, while NC Graphic Converter runs on both Macintosh and
  94. Windows platforms.  See the Slurpee release notes for more details.
  95. 11) To remove the image and sound soup entries, use a soup management
  96. application such as TrashPak (RemoveIt!), StewPot, BitSound, etc.
  97. 12) WARNING - PALMEDIA Player 2.0 operates in landscape and portrait screen
  98. modes.  However, if you rotate the screen with PALMEDIA Player running,
  99. PALMEDIA Player will not properly resize its screen.  The close box will not
  100. be visible.  You should exit PALMEDIA Player before changing the screen
  101. orientation.
  102.  
  103. Notes on this version of PALMEDIA Player:
  104. * The player looks for either of 2 Newton soups.  One, called "Bitmaps"
  105. contains all of the images transferred from the desktop to the Newton via
  106. Slurpee.  The second soup, called "NewtPaint" contains all of the images
  107. created with NewtPaint.  You'll need to put (or create) images in either of
  108. these soups before PALMEDIA Player becomes useful (otherwise, you're stuck
  109. looking at the built-in title picture).  While not necessary, it is
  110. recommended that your images be no larger than 234 pixels across by 290
  111. pixels down for portrait screen orientation or 314 pixels across by 210
  112. pixels down for landscape screen orientation.  Images larger than these sizes
  113. will be clipped to fit the display area.
  114. * NewtPaint owners can create their own graphics and then switch to PALMEDIA
  115. Player for viewing as a slide show or a movie.  NewtPaint and PALMEDIA
  116. Player can be used for making cel animations.
  117. * You may transfer a sound file into a soup called "pmSndTrk" which will
  118. enable audio playback.  Note that this sound plays only once (when autoplay
  119. is started).  Also note that the player will just search for the first entry
  120. in "pmSndTrk", all other sound files are ignored.  In order to hear any
  121. soundtrack, open Extras > Prefs > Sound and turn on "Action sound effects."
  122. Also adjust the volume to a comfortable level.
  123. * To use PALMEDIA Player as a Newt's Cape helper application, add a similar
  124. line to your HTML document:
  125. <a href="PMPlay2.0:LeeMoon">Touch Here</a> to run PALMEDIA Player.
  126. Make sure PALMEDIA Player and your images are already loaded.  The resulting
  127. Newt's Cape book will locate PALMEDIA Player and run it once you tap on the
  128. "Touch Here" hyperlink.  This will allow you to run a slideshow or animation
  129. directly from a Newt's Cape generated Newton Book!
  130.  
  131. Future enhancements:
  132. 1) Add some sort of scripting to let the user choose the time delay and
  133. transition effect for every image (i.e., display image 1 for 2 seconds with
  134. the dissolve transition, display image 2 for 5 seconds with the confetti
  135. transition,...)
  136. 2) Make a better information screen instead of the current screen.
  137. 3) Create more special effects (and weed out the boring ones!)
  138. 4) Add better sound playback support.
  139. 5) Create built-in Help.
  140. 6) Revise this documentation for better explanations on importing graphics
  141. via Slurpee, creating animation frames from Mac and PC, and various hints and
  142. tips for using all the tools.
  143.  
  144. For further information, questions, or comments you may contact me via the
  145. following:
  146. AOL:  LeeMoon  (LeeMoon@aol.com)
  147. CompuServe:  76641,3317
  148. URL:  http://members.aol.com/LeeMoon/
  149.  
  150. If you decide to register PALMEDIA Player, please send $10 (cash or check)
  151. to:
  152. Lee Moon
  153. 2914 W. Neptune St.
  154. Tampa, FL 33629
  155.  
  156. I may set up a Compuserve software registration number later.
  157.  
  158. I'd like to thank all the folks who have used Newton Movie Player, Newton
  159. Slide Show, and PALMEDIA Player version 1.0.  Thanks for trying PALMEDIA
  160. Player version 2.0!
  161. Lee Moon
  162.  
  163. Version history:
  164. 1.0 beta 0 - 10/10/95
  165.      Released for beta testing.
  166.  
  167. 1.0 beta 1 - 10/12/95
  168.      Fixed heap space problem which caused Restart errors if the Bitmaps soup
  169. was larger than available heap space.  The unfortunate consequence of this is
  170. that movie playback is degraded.  I'll have to come up with a faster method
  171. of retrieving the images.
  172.      Made BETA Warning Screen display only on package startup.  You won't see
  173. the BETA screen during slide show or movie playback.  The BETA Warning Screen
  174. will be replaced by the PALMEDIA Player Title Screen when the product is
  175. released into the public domain.
  176.  
  177. 1.0 beta 2 - 10/16/95
  178.      Put sound playback code back in.
  179.      Put beta version number in the "i" button information screen.
  180.      Declared local variables and saved package in uncompressed format in an
  181. attempt to speed up movie playback.
  182.      Rewrote image retrieval from soups using index and key queries.
  183. DRAMATIC improvement in speed!  Movie mode playback speed is now equal to
  184. Newton Movie Player!!!
  185.      There is currently a maximum of 300 images that can be used.  I will
  186. likely remove this limit in an upcoming release.  I've loaded 98 images (the
  187. animation frames from my NMP demo) without any difficulties.
  188.  
  189. 1.0 - 11/30/95
  190.      Public release!
  191.      Replaced Beta startup screen with PALMEDIA Player startup screen.
  192.      Changed "i" button information screen (removed Beta version).
  193.      A BIG "Thank you" to everyone who participated in the beta test phase!!!
  194.  
  195. 1.5 Beta - 3/11/96 (not publicly released)
  196.      Optimized playback for Newton OS 2.0 (turned off Newton 2.0's Busy
  197. Icon).
  198.      Made code a Newton OS 2.0 package.
  199.      Removed status bar (clock and power).
  200.      Updated Info button, startup screen, and documentation.
  201.      Renamed package to PMPlay (old name was PALMplay).
  202.  
  203. 1.6 Beta - 3/13/96 (not publicly released)
  204.      Revised this version to access Landware's NewtPaint image soup.
  205.      Updated Info, startup screen, and documentation accordingly.
  206.  
  207. 1.7 Beta - 3/14/96 (not publicly released)
  208.      Increased screen size for main app and the image view.
  209.      Shrunk buttons to give more room for the soup chooser button.
  210.      Added Bitmaps/NewtPaint button to toggle between the 2 soups.  Button
  211. doesn't work yet.
  212.      Removed protoTitle from app to give more room for images.
  213.      Updated Info, startup screen, and documentation accordingly.
  214.  
  215. 1.8 Beta - 3/15/96 (not publicly released)
  216.      Activated Bitmaps/NewtPaint toggle button.
  217.      Revised up/down arrow buttons to show soup toggle button.
  218.      Play button hides/shows soup toggle button to disallow changing soups
  219. when autoplay is running.
  220.      Updated Info, startup screen, and documentation accordingly.
  221.  
  222. 1.9 Beta - 3/16/96 (not publicly released)
  223.      Changed effects button to a pop up list.
  224.      Updated Info button and documentation accordingly.
  225.  
  226. 1.9a Beta - 3/17/96 (not publicly released)
  227.      Application now resizes to screen dimensions.
  228.      Made application rotate-savvy.  Currently works in portrait and
  229. landscape screen orientations.
  230.      Changed image view fill pattern to improve view redrawing speed.
  231.      *KNOWN BUG* - You can't rotate the screen with PALMEDIA Player running -
  232. it doesn't redraw properly, leaving the close box offscreen.  To change
  233. between landscape/portrait, exit PALMEDIA Player, rotate the screen, and
  234. re-open PALMEDIA Player.
  235.  
  236. 1.9b Beta - 3/20/96 (not released)
  237.      Put all buttons on a floating palette.  It functions fine, but takes
  238. more room than having buttons on the main screen.
  239.  
  240. 1.9c Beta - 3/23/96 (not publicly released)
  241.      Removed floating palette from 1.9b.
  242.      Added new special effect (Angles).
  243.      Put hooks in for using the Overview button for something (perhaps
  244. picture information, i.e. name, size, etc.)
  245.      Updated Info button and documentation accordingly.
  246.      Wrote PALMEDIA Image Transfer (HyperCard stack) as a companion to
  247. PALMEDIA Player.
  248.  
  249. 2.0 - 3/27/96
  250.      Public Release of version 2.0!
  251.      Removed hooks for using the Overview - I'll think of something to throw
  252. into a later release.
  253.      Removed BETA screens and updated Info button, Startup screen, and
  254. documentation accordingly.
  255.  
  256.